home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wc35auto.zip / WC35AUTO.DOC < prev    next >
Text File  |  1992-07-04  |  6KB  |  122 lines
  1. WC35AUTO    (c) 1992             Karl Schneider
  2.                                  8505 Woodwick Ct.
  3. For Wildcat! 3.5+ ONLY!          Tampa, FL 33615
  4.                                  813-884-9661 voice day/eve
  5.                                   "   "    "  bbs midnite-0800 EST
  6.                                               14.4 HST
  7. =====================================================================
  8.  
  9.                         About The Program
  10.  
  11. WC35AUTO is a completely new 'auto-description' utility program
  12. (similar to AUTODESC for earlier Wildcats) for Wildcat 3.5 and
  13. later, and supports the EXTENDED file Descriptions as well as the
  14. 'basic' 60 character descriptions in the main WC File database record.
  15.  
  16. It will NOT work with 3.02 or ANY EARLIER VERSION.
  17.  
  18. What WC35AUTO does is check .ZIP, .LZH or .ARJ files AS THEY ARE
  19. UPLOADED (via SCANFILE.BAT) for a DESC.SDI or FILE_ID.DIZ.  If there
  20. is a DESC.SDI description file in the archive, this will automat-
  21. ically be put into its Wildcat 3.5 File Database record DESCRIPTION.
  22. If there is ALSO a FILE_ID.DIZ description file, the text from it
  23. will be placed in the EXTENDED (detailed) description, WHETHER THE
  24. UPLOADER DOES OR DOES NOT TYPE IN ANY DESCRIPTION WHEN PROMPTED!
  25.  
  26. Note, however, that if there IS a FILE_ID.DIZ file in the archive,
  27. but there is NO DESC.SDI file, the program will NOT put descriptions
  28. in automatically!  This is because very often the first line of
  29. a typical FILE_ID.DIZ file doesn't contain very much useful infor-
  30. mation.  Even using the first 60 characters (maximum allowed by
  31. Wildcat for the 'primary' description) is risky, so I've chosen
  32. to set it up this way at present.  Perhaps someday these will all
  33. become more standardized and it will be possible to make the pro-
  34. gram a bit more versatile.  In the meantime, I've tried to make the
  35. program include as much useful information as possible in the
  36. description - therefore, if the DESC.SDI file only contains, say,
  37. 20 characters, I add up to 40 characters from FILE_ID.DIZ (if it exists)
  38. to make up the 60 character field,  hopefully adding a bit more useful
  39. information.
  40.  
  41. You can tell your users that when they upload archive files con-
  42. taining DESC.SDI and FILE_ID.DIZ, when asked by Wildcat for
  43. descriptions, just press Enter (or type anything else...WC35AUTO will
  44. over-write it anyway).  This does appeal to many users, not having
  45. to type descriptions online after uploading; they can simply
  46. press <enter> when prompted for 'description' (when DESC.SDI is
  47. included in the upload) and 'detailed description' (when FILE_ID.DIZ
  48. is also included).
  49.  
  50. Uploads with extensions other than .ZIP, .ARJ and .LZH are ignored.
  51. -----------------------------------------------------------------------
  52.  
  53.                        To use WC35AUTO:
  54.  
  55. 1.  You must have PKUNZIP.EXE on your system so that it can be run
  56.     from your WC Home directory...(in your PATH or WC dir)
  57.     If you allow .ARJ and/or .LZH uploads, you must ALSO have ARJ.EXE
  58.     and LHARC.EXE pathed.  If you have a variant of LHARC called
  59.     LHA.EXE, you must either re-name it or COPY it to LHARC.EXE.
  60.  
  61. 2.  The Environment variable WCNODEID must be set for the node in
  62.     question.
  63.  
  64. 3.  You MUST have the latest WCFILE.EXE program from MSI (version
  65.     3.5 or later) in your PATH or WC Home directory.  Earlier ver-
  66.     sions of WCFILE will NOT work correctly!
  67.  
  68. 4.  Put WC35AUTO.EXE anywhere in your PATH.
  69.  
  70. 5.  Create or add to your SCANFILE.BAT (in your Wildcat Home directory)
  71.     the following command:
  72.  
  73.     wc35auto %1
  74.  
  75. If for any reason you do NOT want the program to add KEYWORDS,
  76. add 'nk' at the end, like this:
  77.  
  78.     wc35auto %1 nk
  79.  
  80. (remember, you can create a BADKEYS.LST file to keep words like 'the',
  81. 'is', 'new', etc., from being placed into the key fields).
  82. -------------------------------------------------------------------------
  83.  
  84. That's all there is to it!  Please note that if you are doing OTHER
  85. things in SCANFILE that require you to change directory, like maybe
  86. to the wcwork\node%NODEID% , you will need to CD back to the WCat
  87. HOME dir before executing WC35AUTO.
  88.  
  89. Remember to tell your users that ONLY 60 characters are allowed for
  90. the primary (DESC.SDI) description for Wildcat, and FILE_ID.DIZ
  91. (which is pretty well standardized) is limited to 15 lines of 45
  92. characters!  WC35AUTO will chop off any text exceeding these limits.
  93. My PUTDESC program (available on my board and others), makes adding
  94. these description files fairly fast and painless.
  95.  
  96. Note that WC35AUTO will also work with LOCAL uploads; so that is a
  97. way you can add descriptions to your own uploads without having to
  98. type them in while you're logged in locally...
  99.  
  100. Try to let your users know that WC35AUTO is installed...maybe a
  101. bulletin, a short note in your PREUP.BBS display file, or both,
  102. explaining that DESC.SDI is needed, and FILE_ID.DIZ is optional
  103. to be able to skip entering file descriptions when uploading.
  104.  
  105. I have tested this program as carefully and thoroughly as possible, and
  106. have not had any reports of problems, but as with any software, wide
  107. variations in system configurations can sometimes cause unexpected or
  108. unforseeable results.  For this reason, I make no warranties with
  109. respect to this program as to its usability, safety to data, or any
  110. results deriving from its use, and accept no responsibility for any
  111. loss or damages directly or indirectly caused by using it.
  112.  
  113. This program is shareware, you may use it for a reasonable time for
  114. evaluation, after which you should register it.  This will insure
  115. future support for this and other Wildcat utility programs.
  116. If you contribute $40 or more, you will be entitled to registration
  117. and support on ALL my WC3 utilities.  That's under $1.00 apiece!
  118.  
  119. Any bug reports, comments or suggestions are solicited and welcome!
  120. Thanks.
  121.  
  122.